IBMESCON-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, enterprises, Counter32, OBJECT-TYPE, Integer32, IpAddress FROM SNMPv2-SMI OBJECT-GROUP, MODULE-COMPLIANCE FROM SNMPv2-CONF MacAddress FROM SNMPv2-TC ifIndex FROM RFC1213-MIB; ibmESCON MODULE-IDENTITY LAST-UPDATED "9702241200Z" ORGANIZATION "IBM" CONTACT-INFO "Bob Moore (remoore @ ralvm6) IBM Corporation 800 Park Offices Drive CNMA/664 P.O. Box 12195 Research Triangle Park, NC 27709, USA Tel: 1 919 254 4436 E-mail: remoore@ralvm6.vnet.ibm.com John Rooney (rooney @ yktvmv) Valerie Zoccola (zoccolav @ lgeprofs)" DESCRIPTION "MIB for managing activity on an ESCON channel from its secondary end. 'ESCON' is a trademark of the IBM Corporation." ::= {ibmArchitecture 17 } ibm OBJECT IDENTIFIER ::= { enterprises 2 } ibmArchitecture OBJECT IDENTIFIER ::= { ibm 5 } esconPortData OBJECT IDENTIFIER ::= { ibmESCON 1 } esconLinkData OBJECT IDENTIFIER ::= { ibmESCON 2 } esconStationData OBJECT IDENTIFIER ::= { ibmESCON 3 } esconConformance OBJECT IDENTIFIER ::= { ibmESCON 4 } -- This MIB contains three tables, for managing an ESCON configuration -- as shown here: -- -- Host 1 Host 2 -- ************************** *************** -- .d-1..d-y d1...d-y. . . -- . . . . -- . PN-1 ... PN-xx . . . -- ************************** *************** -- HLA-1 . HLA-2 . -- . . -- **************************************** -- . ESCON Director . -- . . -- **************************************** -- CULA-1. CULA-2. -- . . -- ***************************************************** -- . ----------- ------------ . -- . . ESCON . . ESCON . . -- . . port 1 . . port 2 . . -- . ----------- ------------ . -- . . -- . Device supporting this MIB . -- ***************************************************** -- -- - ESCON port table represents an ESCON physical port. As shown, -- a device may support more than one ESCON port. This table -- is indexed by ifIndex from MIB-II. The entry for this port in -- ifTable uses the ifType value 73 (ESCON). -- -- Note that the Control Unit Link Address (CULA), identifying the -- port on the ESCON Director to which an ESCON port is optically -- connected, is a non-index object in this table. -- -- - ESCON link table represents a link between an ESCON device -- and a "logical host" within an actual host. This table has -- a three-part index: -- -- - ifIndex from MIB-II, identifying the ESCON port -- supporting the link -- - esconLinkHostLinkAddress (HLA), identifying the actual -- host for the link. -- - esconLinkPartitionNumber (PN), identifying the "logical -- host" for the link, within the actual host identified -- by esconLinkHostLinkAddress. -- -- - ESCON station table represents a link station in an ESCON -- device. This table has a four-part index: -- -- - ifIndex from MIB-II, identifying the ESCON port -- supporting the link -- - esconStationHostLinkAddress (HLA), identifying the actual -- host for the link. -- - esconStationPartitionNumber (PN), identifying the "logical -- host" for the link, within the actual host identified -- by esconLinkHostLinkAddress. -- - esconStationDeviceAddress (d-n in the figure), identifying -- the device address by which the host knows the station. -- -- ****************************************************************** -- IBM ESCON port table -- ****************************************************************** esconPortTable OBJECT-TYPE SYNTAX SEQUENCE OF EsconPortEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Table of objects that describe an ESCON channel port." ::= { esconPortData 1 } esconPortEntry OBJECT-TYPE SYNTAX EsconPortEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Table of objects that describe an ESCON channel port. This table is indexed by ifIndex from MIB-II." INDEX { ifIndex } ::= { esconPortTable 1 } EsconPortEntry ::= SEQUENCE { esconPortControlUnitLinkAddress OCTET STRING, esconPortInFiberStatus INTEGER, esconPortOutFiberStatus INTEGER } esconPortControlUnitLinkAddress OBJECT-TYPE SYNTAX OCTET STRING (SIZE(2)) MAX-ACCESS read-only STATUS current DESCRIPTION "This address identifies the ESCON Director port to which the optical fiber from the ESCON device is attached." ::= { esconPortEntry 1 } esconPortInFiberStatus OBJECT-TYPE SYNTAX INTEGER { inLoff(1), inOls(2), inIdle(3), inUnknown(4) } MAX-ACCESS read-only STATUS current DESCRIPTION "Status of the fiber into this device from the host: inLoff = the light is off on the fiber into this device from the host inOls = the fiber into this device from the host is in an intermediate state between light-off and light-on inIdle = the fiber into this device from the host is in the light-on state, and is ready to transfer data from the host to this device inUnknown = the agent cannot determine the status of the fiber into this device from the host" ::= { esconPortEntry 2 } esconPortOutFiberStatus OBJECT-TYPE SYNTAX INTEGER { outDisableReq(1), outDisableForced(2), outLoffForced(3), outOls(4), outOlsForced(5), outEnable(6), outError(7) } MAX-ACCESS read-only STATUS current DESCRIPTION "Status of the fiber out of this device to the host: outDisableReq = out disable obtained; the fiber out of this device into the host is not in the light-on state outDisableForced = out ESCON emits OLS; the fiber out of this device into the host is not in the light-on state outLoffForced = out ESCON forced light-off; the fiber out of this device into the host is not in the light-on state outOls = the fiber out of this device into the host is in an intermediate state between light-off and light-on outOlsforced = out ESCON forced OLS; the fiber out of this device into the host is not in the light-on state outEnable = the fiber out of this device into the host is in the light-on state, and is ready to transfer data from this device to the host outError = the status of the fiber out of this device to the host is none of those listed above. This is a state that should not occur" ::= { esconPortEntry 3 } -- ****************************************************************** -- IBM ESCON link table -- ****************************************************************** esconLinkTable OBJECT-TYPE SYNTAX SEQUENCE OF EsconLinkEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Table of objects that describe an ESCON channel link." ::= { esconLinkData 1 } esconLinkEntry OBJECT-TYPE SYNTAX EsconLinkEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Table of objects that describe an ESCON channel link. This table is indexed by ifIndex from MIB-II, by host link address, and by (host) partition number." INDEX { ifIndex, esconLinkHostLinkAddress, esconLinkPartitionNumber } ::= { esconLinkTable 1 } EsconLinkEntry ::= SEQUENCE { esconLinkHostLinkAddress OCTET STRING, esconLinkPartitionNumber OCTET STRING, esconLinkStatus INTEGER } esconLinkHostLinkAddress OBJECT-TYPE SYNTAX OCTET STRING (SIZE(1)) MAX-ACCESS not-accessible STATUS current DESCRIPTION "This address identifies the ESCON Director port to which the optical fiber between the ESCON Director and the host is attached." ::= { esconLinkEntry 1 } esconLinkPartitionNumber OBJECT-TYPE SYNTAX OCTET STRING (SIZE(1)) MAX-ACCESS not-accessible STATUS current DESCRIPTION "A number identifying a logical host within an actual host." ::= { esconLinkEntry 2 } esconLinkStatus OBJECT-TYPE SYNTAX INTEGER { hlpNotEstab(1), hlpEstab(2), hlpError(3) } MAX-ACCESS read-only STATUS current DESCRIPTION "Gives the status of the link: hlpNotEstab = Host Logical Path not established hlpEstab = Host Logical Path established hlpError = Host Logical Path error" ::= { esconLinkEntry 3 } -- ****************************************************************** -- IBM ESCON station table -- ****************************************************************** esconStationTable OBJECT-TYPE SYNTAX SEQUENCE OF EsconStationEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Table of objects that describe an ESCON channel station." ::= { esconStationData 1 } esconStationEntry OBJECT-TYPE SYNTAX EsconStationEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Table of objects that describe an ESCON channel station. This table is indexed by ifIndex from MIB-II, by host link address, by (host) partition number, and by ESCON device address." INDEX { ifIndex, esconStationHostLinkAddress, esconStationPartitionNumber, esconStationDeviceAddress } ::= { esconStationTable 1 } EsconStationEntry ::= SEQUENCE { esconStationHostLinkAddress OCTET STRING, esconStationPartitionNumber OCTET STRING, esconStationDeviceAddress OCTET STRING, esconStationState INTEGER, esconStationAttentionDelay INTEGER, esconStationAttentionTimeOut INTEGER, esconStationMaxBfru INTEGER, esconStationUnitSize INTEGER, esconStationMaxMsgSizeReceived INTEGER, esconStationMaxMsgSizeSent INTEGER, esconStationDataPacketsOkReceived Counter32, esconStationDataPacketsKoReceived Counter32, esconStationDataPacketsSent Counter32, esconStationTotalFramesSent Counter32, esconStationDataPacketsRetransmitted Counter32, esconStationPositiveAckDataPackets Counter32, esconStationSecondChanceAttentions Counter32, esconStationCommandsRetried Counter32 } esconStationHostLinkAddress OBJECT-TYPE SYNTAX OCTET STRING (SIZE(1)) MAX-ACCESS not-accessible STATUS current DESCRIPTION "This address identifies the ESCON Director port to which the optical fiber between the ESCON Director and the host is attached." ::= { esconStationEntry 1 } esconStationPartitionNumber OBJECT-TYPE SYNTAX OCTET STRING (SIZE(1)) MAX-ACCESS not-accessible STATUS current DESCRIPTION "A number identifying a logical host within an actual host." ::= { esconStationEntry 2 } esconStationDeviceAddress OBJECT-TYPE SYNTAX OCTET STRING (SIZE(1)) MAX-ACCESS not-accessible STATUS current DESCRIPTION "A unique hexadecimal number allocated to each station on the same host link." ::= { esconStationEntry 3 } esconStationState OBJECT-TYPE SYNTAX INTEGER { idle(1), cpDefined(2), cpReset (3), cpActive(4), cpDelete(5), cpAbend(6), cldpWait(7), cldpDefinedl(8), cldpError(9), cldpLoad(10), cldpDump(11), deletePending(12), deleted(13), cpXidExpected(14) } MAX-ACCESS read-only STATUS current DESCRIPTION "The current state of the station." ::= { esconStationEntry 4 } esconStationAttentionDelay OBJECT-TYPE SYNTAX INTEGER (0 .. 420) UNITS "seconds" MAX-ACCESS read-write STATUS current DESCRIPTION "Specifies the amount of time in seconds that elapses from the receipt of a packet at an ESCON station (when no other packets are queued) before that station sends buffered data to the Host. An update to this object takes effect the next time the station establishes communications with the host." ::= { esconStationEntry 5 } esconStationAttentionTimeOut OBJECT-TYPE SYNTAX INTEGER (10 .. 840) UNITS "seconds" MAX-ACCESS read-write STATUS current DESCRIPTION "Specifies the amount of time in seconds that the station is to wait for a response to an attention signal it sent to the host before initiating channel disconnect. An update to this object takes effect the next time the station establishes communications with the host." ::= { esconStationEntry 6 } esconStationMaxBfru OBJECT-TYPE SYNTAX INTEGER (1 .. 65535) MAX-ACCESS read-only STATUS current DESCRIPTION "Number of buffers in the host buffer pool for receiving data from this station." ::= { esconStationEntry 7 } esconStationUnitSize OBJECT-TYPE SYNTAX INTEGER (64 .. 4000) UNITS "bytes" MAX-ACCESS read-only STATUS current DESCRIPTION "Maximum size of a buffer, in bytes, that the host can receive from this station." ::= { esconStationEntry 8 } esconStationMaxMsgSizeReceived OBJECT-TYPE SYNTAX INTEGER (0 .. 65535) MAX-ACCESS read-write STATUS current DESCRIPTION "The maximum length of a message that can be received on this station. An update to this object takes effect the next time the station establishes communications with the host." ::= { esconStationEntry 9 } esconStationMaxMsgSizeSent OBJECT-TYPE SYNTAX INTEGER (0 .. 65535) MAX-ACCESS read-write STATUS current DESCRIPTION "The maximum length of a message that can be sent from this station to the host. An update to this object takes effect the next time the station establishes communications with the host." ::= { esconStationEntry 10 } esconStationDataPacketsOkReceived OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of data packets received from the host by this station without Data Check." ::= { esconStationEntry 11 } esconStationDataPacketsKoReceived OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of data packets received from the host by this station with Data Check." ::= { esconStationEntry 12 } esconStationDataPacketsSent OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of data packets sent to the host by this station." ::= { esconStationEntry 13 } esconStationTotalFramesSent OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of data packets and control packets sent to the host by this station." ::= { esconStationEntry 14 } esconStationDataPacketsRetransmitted OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of data packets retransmitted by this station" ::= { esconStationEntry 15 } esconStationPositiveAckDataPackets OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of data packets sent by this station to the host that the host has positively acknowledged. When the host sends a positive acknowledgement for a group of n data packets, this counter is incremented by n." ::= { esconStationEntry 16 } esconStationSecondChanceAttentions OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times this station has sent a Second Chance Attention signal to the host." ::= { esconStationEntry 17 } esconStationCommandsRetried OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a command has been retried on this station" ::= { esconStationEntry 18 } -- ****************************************************************** -- IBM ESCON conformance -- ****************************************************************** esconMibCompliances OBJECT IDENTIFIER ::= {esconConformance 1 } esconMibGroups OBJECT IDENTIFIER ::= {esconConformance 2 } esconPortGroup OBJECT-GROUP OBJECTS { esconPortControlUnitLinkAddress, esconPortInFiberStatus, esconPortOutFiberStatus } STATUS current DESCRIPTION "Objects that describe an ESCON channel port." ::= { esconMibGroups 1 } esconLinkGroup OBJECT-GROUP OBJECTS { esconLinkStatus } STATUS current DESCRIPTION "Objects that describe an ESCON channel link." ::= { esconMibGroups 2 } esconStationGroup OBJECT-GROUP OBJECTS { esconStationState, esconStationAttentionDelay, esconStationAttentionTimeOut, esconStationMaxBfru, esconStationUnitSize, esconStationMaxMsgSizeReceived, esconStationMaxMsgSizeSent, esconStationDataPacketsOkReceived, esconStationDataPacketsKoReceived, esconStationDataPacketsSent, esconStationTotalFramesSent, esconStationDataPacketsRetransmitted, esconStationPositiveAckDataPackets, esconStationSecondChanceAttentions, esconStationCommandsRetried } STATUS current DESCRIPTION "Objects that describe an ESCON channel station." ::= { esconMibGroups 3 } esconMibCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for the SNMPv2 entities that implement the IBM ESCON MIB." MODULE -- this module MANDATORY-GROUPS { esconPortGroup, esconLinkGroup, esconStationGroup } OBJECT esconStationAttentionDelay MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT esconStationAttentionTimeOut MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT esconStationMaxMsgSizeReceived MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT esconStationMaxMsgSizeSent MIN-ACCESS read-only DESCRIPTION "Write access is not required." ::= { esconMibCompliances 1 } END